home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / program / ogrid100.zip / README.TXT < prev    next >
Text File  |  1994-12-29  |  10KB  |  234 lines
  1.  
  2.  
  3.                            OOGrid Library(TM) v1.0
  4.                    for Borland/Turbo Pascal (Real Mode/TV)
  5.  
  6.  
  7.                              Copyright (C) 1994
  8.                              by Arturo J. Monge
  9.  
  10.  
  11.                       Portions Copyright (C) 1989,1990
  12.                        by Borland International, Inc.
  13.  
  14.  
  15.                                  README.TXT
  16.  
  17.  
  18. A. WHAT IS 'OOGrid Library (TM) v1.0'?
  19.  
  20.      OOGrid Library(TM) v1.0 is a library of objects for Turbo Vision that
  21. provides a simple spreadsheet for use in your applications.  The spreadsheet
  22. in OOGrid Library(TM) v1.0 can be used, for example, to manage lists, to
  23. browse and edit the data in a database, to create data entry screens or
  24. simply as an ordinary spreadsheet.  The library consists of one main object
  25. -- TSpreadSheet -- and several auxiliary objects used by TSpreadSheet.  Some
  26. of these auxiliary objects (TLimScrollBar, TMessageLine, and TWindowList --
  27. the latter implemented in the demo program) can be used by other objects or
  28. applications not related to OOGrid Library(TM) v1.0.
  29.  
  30.      This library works with Turbo Pascal 6.0 and Borland/Turbo Pascal 7.0,
  31. and can be used to create real mode applications only; it does not work
  32. properly in protected mode applications.
  33.  
  34.  
  35. B. WHAT DOES 'OOGrid Library(TM) v1.0' DO?
  36.  
  37.      The spreadsheet object provided with OOGrid Library(TM) v1.0 can handle
  38. text, values, formulas and repeat characters.  It supports several numerical
  39. functions (abs, trunc, round, exp, sin, cos, atan, sqr, sqrt, and ln) and
  40. operations (+, -, /, *, :, and ^) that can be used in formula or value cells. 
  41. It lets you mark, copy, move and erase blocks of cells, insert and delete
  42. columns and rows, change the width of a column or block of columns, and
  43. assign a custom header to any column in the spreadsheet. You can justify
  44. (left, center or right) the contents of a cell, and format numbers by adding
  45. commas, a currency character or by changing the number of decimals displayed. 
  46. There is also a sort function that lets you sort the rows of a block of cells
  47. using three different sort keys, in either ascending or descending order.
  48.  
  49.      The spreadsheet supports three modes of operation that you can toggle on
  50. and off independently: autocalc mode, in which all the formula cells are
  51. recalculated every time you add or modify a cell; display formulas mode, in
  52. which all formulas and not their results are displayed; and display headers
  53. mode, in which all custom assigned headers are displayed. There is also a
  54. spreadsheet protection feature, that lets you protect the data in the
  55. spreadsheet; when the spreadsheet is protected, only marked (unlocked) cells
  56. can be changed.  This feature is useful for creating data entry screens.
  57.  
  58.      The spreadsheet also offers several printing options.  You can print a
  59. file in normal or condensed mode and choose whether or not to print the
  60. column headers and/or the row numbers.  You can print row outlines and print
  61. the column headers and row numbers in bold characters, and also define the
  62. page layout (margins and number of columns and rows in a page).
  63.  
  64.  
  65. C. SOURCE CODE
  66.  
  67.      More than 100 pages of source code are included with OOGrid Library (TM)
  68. v1.0.  However, the source code of GLCell.PAS, GLLStr.PAS, GLParser.PAS,
  69. TCHash.PAS and TCUtil.PAS was not included because it is mainly Borland's
  70. code.  The interface sections of these units and the corresponding *.TPU
  71. files are included instead (the file TP60_TPU.ZIP contains the *.TPU files
  72. for Turbo Pascal 6.0).
  73.  
  74.  
  75. D. LICENSE AGREEMENT
  76.  
  77.      You must read and accept the license agreement before using OOGrid
  78. Library(TM) v1.0 for Borland/Turbo Pascal (Real Mode/TV).  See the file
  79. LICENSE.TXT. 
  80.  
  81.  
  82. E. DESCRIPTION OF FILES
  83.  
  84.      Before using OOGrid Library(TM) v1.0 the first time, make sure you have
  85. all the following files;  if not, please contact the author immediately.
  86.  
  87.  Demo files:
  88.  
  89.      DEMOEQU.PAS    Equates unit for the demo program
  90.      DEMOMAKE.PAS   Program that creates the resource file used by the demo
  91.                     program
  92.      DEMO_GL.EXE    Demo program
  93.      DEMO_GL.PAS    Source code of the demo program
  94.  
  95.  Example files:
  96.  
  97.      EX_ENTRY.OGL   Two examples of data entry screens
  98.      EX_ERROR.OGL   Different errors reported by TSpreadSheet
  99.      EX_FUNCT.OGL   Different functions and operations supported by
  100.                     TSpreadSheet
  101.      EX_LICEN.OGL   License agreement.  MUST READ!
  102.      EX_LIST1.OGL   Some information about column headers and the sort
  103.                     function
  104.      EX_LIST2.OGL   An example list
  105.      EX_OOGL2.OGL   Information about next releases
  106.      EX_TYPES.OGL   Examples of the different types of cells supported by
  107.                     TSpreadSheet
  108.  
  109.  Source code files:
  110.  
  111.      GLEQUATE.PAS   Equates unit used by TSpreadSheet
  112.      GLSORT.PAS     Implementation of an object that can sort a cell hash
  113.                     table using three different keys
  114.      GLSUPPRT.PAS   Several support constants, variables, records and objects
  115.                     used by TSpreadSheet
  116.      GLTSHEET.PAS   This is the main unit, which implements the TSpreadSheet
  117.                     object
  118.      GLTVR_US.PAS   Implements two functions needed to create the resources
  119.                     used by TSpreadSheet
  120.      GLVIEWS.PAS    Implementation of several support views used by
  121.                     TSpreadSheet
  122.      GLWINDOW.PAS   Implementation of a TWindow's descendant that can own a
  123.                     TSpreadSheet object
  124.  
  125.  Interface sections files:
  126.  
  127.      GLCELL.INT     Implementation of the different cell and hash table
  128.                     objects used by TSpreadSheet.  Interface section of the
  129.                     GLCELL.PAS unit
  130.      GLLSTR.INT     Implementation of a long string object. Interface section
  131.                     of the GLLSTR.PAS unit
  132.      GLPARSER.INT   Implementation of the parser used by TSpreadSheet. 
  133.                     Interface section of the GLPARSER.PAS unit
  134.      TCHASH.INT     Interface of Borland's TCHASH.PAS unit, which implements
  135.                     the HashTable object
  136.      TCUTIL.INT     Interface of Borland's TCUTIL.PAS unit, which implements
  137.                     several support functions used by TSpreadSheet
  138.  
  139.  Compiled units:
  140.  
  141.      GLCELL.TPU     Compiled with Borland Pascal 7.0
  142.      GLLSTR.TPU     Compiled with Borland Pascal 7.0
  143.      GLPARSER.TPU   Compiled with Borland Pascal 7.0
  144.      TCHASH.TPU     Compiled with Borland Pascal 7.0
  145.      TCUTIL.TPU     Compiled with Borland Pascal 7.0
  146.  
  147.  Text files:
  148.  
  149.      README.TXT     This file.
  150.      LICENSE.TXT    License agreement.  MUST READ!
  151.      NEXTRLSE.TXT   Information about future releases of OOGrid Library(TM)
  152.      MANUAL.TXT     Documentation of most of the units in OOGrid Library(TM)
  153.                     v1.0
  154.  
  155.  Compressed files:
  156.  
  157.      TP60_TPU.ZIP   *.TPU files compiled with Turbo Pascal 6.0
  158.  
  159.  Utilities
  160.  
  161.      PRINTDOC.EXE   Use this program to print the documentation
  162.      PRINTDOC.PAS   Source code of the PRINTDOC.EXE program
  163.  
  164.  
  165. F. REQUIREMENTS
  166.  
  167.      Turbo Pascal 6.0 or Borland/Turbo Pascal 7.0
  168.      Turbo Vision 1.0 or Turbo Vision 2.0
  169.  
  170.  
  171. G. HOW TO USE 'OOGrid Library (TM) v1.0'
  172.  
  173.      There are several things that you must do before creating the first
  174. instance of a TSpreadSheet object in an application:
  175.  
  176.      1- Create a resource file, using the CreateOOGLDialogs and
  177.      CreateOOGLStrings functions in the GLTVR_US unit.
  178.  
  179.      2- Add new palette entries to the standard application palettes.
  180.  
  181.      3- Assign values to two pointer variables:
  182.  
  183.      a) GLResFile, which is a pointer to the resource file containing the
  184.      dialogs created using the CreateOOGLDialogs function (seeGLTVR_US.PAS). 
  185.      Remember to close and dispose the corresponding resource file before
  186.      terminating your application.
  187.  
  188.      b) GLStringList, which is a pointer to the string list created using the
  189.      CreateOOGLStrings function (see GLTVR_US.PAS).  Remember to dispose the
  190.      corresponding TStringList object before terminating your application.
  191.  
  192.  
  193.  
  194.      The source code in DEMOMAKE.PAS and DEMO_GL.PAS shows you how to create
  195. the resource file needed by TSpreadSheet, extend the standard application
  196. palettes, initialize the GLResFile and GLStringList variables, and how to use
  197. a TSpreadSheetWindow and TSpreadSheet object in an application.
  198.  
  199.  
  200. H. ABOUT THE DOCUMENTATION
  201.  
  202.      The file MANUAL.TXT contains the documentation of OOGrid Library(TM)
  203. v1.0. There is a short description of almost every unit in this library, and
  204. a description, in alphabetical order, of almost every variable, constant and
  205. type declared in those units.  Each description has an identifier
  206. declaration, the unit in which the identifier is declared, its function, its
  207. parameters' description (if any) and important remarks about the identifier
  208. (if any).
  209.  
  210.      The units GLParser.PAS, GLLStr.PAS, TCHash.PAS and TCUtil.PAS are not
  211. documented.
  212.  
  213.  
  214. I. HOW TO CONTACT THE AUTHOR
  215.  
  216. You can contact the author at any of the addresses listed below:
  217.  
  218.  E-MAIL:
  219.       INTERNET:          mongev@cariari.ucr.ac.cr
  220.       CLEVELAND FREENET: fh441@freenet.cleveland.edu
  221.  
  222.  MAIL:
  223.       Arturo J. Monge
  224.       SJO 1684; POB 025216
  225.       Miami, FL 33102-5216
  226.  
  227. Sending correspondence via electronic mail is strongly preferred.
  228.  
  229. Please feel free to contact the author at any time to share your comments
  230. about this software and/or licensing policies, to ask questions about the use
  231. of this library and (please!) to report any bugs you may find.
  232.  
  233. Thanks a lot for you support!
  234.